AgentScope-Java Version

1.0.12 (development)

Description

DataBlock is documented as the forward-looking unified container for all binary modalities (image / audio / video / file), replacing the legacy ImageBlock / AudioBlock / VideoBlock subclasses. However, none of the provider message converters handled it — when a user built a message with DataBlock, every provider silently dropped the block and the LLM received no media content.

This PR fixes that gap.

Changes:

• URLSource: Add optional mimeType field for extension-less URLs (CDN signed URLs, API-generated media links). Backward-compatible — existing callers using the single-arg constructor or omitting mime_type in JSON are unaffected. MIME type resolution priority: Base64Source.mediaType > URLSource.mimeType > extension-based inference via MediaUtils.determineMediaType.

• DashScope: Add convertDataBlockToContentPart to DashScopeMediaConverter; add DataBlock branch to DashScopeMessageConverter (both convertToMultimodalContent and hasMediaContent / convertContentBlocks).

• Gemini: Add convertToInlineDataPart(DataBlock) to GeminiMediaConverter; add DataBlock branch in GeminiMessageConverter; fix extractSourceFromBlock which previously threw on DataBlock.

• Anthropic: Add convertDataBlock to AnthropicMediaConverter (image-only — Anthropic SDK does not expose a generic binary content block param); add DataBlock branch to AnthropicMessageConverter.

• OpenAI: Add DataBlock branch to OpenAIMessageConverter (routes to image / audio / video based on MIME prefix); add resolveMimeType utility to OpenAIConverterUtils.

How to test:

Msg msg = Msg.builder()
    .role(MsgRole.USER)
    .content(DataBlock.builder()
        .source(URLSource.builder()
            .url("https://example.com/photo.jpg")
            .build())
        .build())
    .content(TextBlock.builder().text("Describe this image").build())
    .build();

Previously the image was silently dropped; now it is routed correctly to each provider's image slot.

For extension-less URLs:

URLSource.builder()
    .url("https://cdn.example.com/media/abc123")
    .mimeType("video/mp4")
    .build()

Closes #1932

Checklist

• Code has been formatted with mvn spotless:apply
• All tests are passing (mvn test)
• Javadoc comments are complete and follow project conventions
• Related documentation has been updated (e.g. links, examples, etc.)
• Code is ready for review